The Maestro User Interface and the Administration Hub components permit limited User Interface branding by allowing the administrator the choice of using institutional or company logo images instead of the LISTSERV Maestro logos, and by adding a few text strings at prominent locations, such as the header and footer of each page.
To do this, the administrator must create a text file called custom.properties that must be located in the relevant application folder.
This file must be a text file that follows the rules of LISTSERV Maestro INI files (see the LISTSERV Maestro Administrator’s Manual for details). This means that the file must consist of entries of the form
key=value, with which the administrator can define customized text strings.
Each custom text string consists of a key=value pair, where the key is as listed below, and the value is the text that is to appear in the User Interface (and follows the INI file rules). The following text string keys are currently available for customization:
Sets YOUR_TEXT to be used in the window title bar of each browser window that is used to access the Maestro User Interface or the Administration Hub component. The text will appear as the first text in the title bar, before the application name. If this key is not included, the text “L-Soft” will be shown. Supply an empty value to not show any text before the application name.
Adds YOUR_TEXT as a header text at the top of the page. The header text will be drawn so that it will appear on top of the blue header bar shown at the top of each page. The blue header bar will be the background behind the text, which is drawn with a white, bold faced font, about as large as the page headers that appear on each page right below the header bar. If this key is not included, no text will be shown.
Adds YOUR_TEXT as a footer text at the bottom of the page. The footer text will be drawn in the bottom left corner of each page where it will appear to the left of the Protected by F-Secure message (if available). It will be drawn in the same small standard page font as the F-Secure message. If this key is not included, no text will be shown.
Uses YOUR_URL (must be a valid “
http://…” URL) as the target link of the logo that appears at the top-right of each page. This logo is set to the LISTSERV Maestro logo with a target URL of
http://www.lsoft.com. Customizing the logo’s target URL is most effective when used together with exchanging the LISTSERV Maestro logo with a customized institutional or company logo (see below). If this key is not included, the URL will point to
http://www.lsoft.com.
Important: In previous versions of LISTSERV Maestro, this feature was available for the User Interface and the Administration Hub. Starting in LISTSERV Maestro 3.0, this feature is no longer available for the User Interface. If you have customized images in place from previous versions for the User Interface, and then upgrade to 3.0 or higher, then these images will be ignored.
In order to replace the LISTSERV Maestro logo image files, prepare the customized image files and save them in either GIF or JPG format. There are size restrictions for the files, which are detailed below. Create a folder named
custom in the
hub directory. Save the image files in these custom folders so that the files are accessible to LISTSERV Maestro and so that the files will not be changed or deleted by LISTSERV Maestro’s upgrade routine (although the folders may be deleted during a full uninstall of LISTSERV Maestro).
Once the images are saved in the custom folder, LISTSERV Maestro needs to know about them. Do so with the same sort of
key=value entries in the
custom.properties file(s) as described above. Each key’s value must be a relative filename that starts with a forward slash “/” and includes the name of the custom folder itself as the first path element (using the forward slash as the separator), such as “
/custom/myImage.gif”.
Uses the image file with the FILENAME from the custom folder to replace the LISTSERV Maestro logo image that is shown at the right of the header bar that appears at the top of each page. This logo is also a clickable link that may be customized. Set the target URL with the
app.url.companyURL key (see above). This image must be 60 x 60 pixels in size. If this key is not included, the LISTSERV Maestro logo will be used.
Uses the file with the FILENAME from the custom folder to replace the LISTSERV Maestro logo image that is shown on the login page when the Administration Hub is not accessible. Under normal conditions, the login page only shows the image in the header bar, plus the fields for the login. However, if the Administration Hub is locked by the administrator or is for other reasons not correctly running, the login page displays this logo and a short message text, instead of the login fields. This logo image should be about 113 x 113 pixels in size, but the size may vary (within reasonable limits). If this key is not included, a version of the LISTSERV Maestro logo will be used.
